/*
 * Copyright 2002-2007 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.beans.factory;

/**
 * #Comment#:如果Bean实现了这个接口，将调用setBeanName方法，将配置文件中该Bean对应的名称设置到Bean中。
 * <p>
 * Interface to be implemented by beans that want to be aware of their bean name
 * in a bean factory. Note that it is not usually recommended that an object
 * depend on its bean name, as this represents a potentially brittle dependence
 * on external configuration, as well as a possibly unnecessary dependence on a
 * Spring API.
 * 
 * <p>
 * For a list of all bean lifecycle methods, see the {@link BeanFactory
 * BeanFactory javadocs}.
 * 
 * @author Juergen Hoeller
 * @since 01.11.2003
 * @see BeanClassLoaderAware
 * @see BeanFactoryAware
 * @see InitializingBean
 */
public interface BeanNameAware {

	/**
	 * Set the name of the bean in the bean factory that created this bean.
	 * <p>
	 * Invoked after population of normal bean properties but before an init
	 * callback such as {@link InitializingBean#afterPropertiesSet()} or a
	 * custom init-method.
	 * 
	 * @param name
	 *            the name of the bean in the factory. Note that this name is
	 *            the actual bean name used in the factory, which may differ
	 *            from the originally specified name: in particular for inner
	 *            bean names, the actual bean name might have been made unique
	 *            through appending "#..." suffixes. Use the
	 *            {@link BeanFactoryUtils#originalBeanName(String)} method to
	 *            extract the original bean name (without suffix), if desired.
	 */
	void setBeanName(String name);

}
